package com.lekang.system.service;

import java.util.List;
import com.lekang.system.domain.Bill;

/**
 * 入账列表Service接口
 * 
 * @author ruoyi
 * @date 2025-10-13
 */
public interface IBillService 
{
    /**
     * 查询入账列表
     * 
     * @param id 入账列表主键
     * @return 入账列表
     */
    public Bill selectBillById(Long id);

    /**
     * 查询入账列表列表
     * 
     * @param bill 入账列表
     * @return 入账列表集合
     */
    public List<Bill> selectBillList(Bill bill);

    /**
     * 新增入账列表
     * 
     * @param bill 入账列表
     * @return 结果
     */
    public int insertBill(Bill bill);

    /**
     * 修改入账列表
     * 
     * @param bill 入账列表
     * @return 结果
     */
    public int updateBill(Bill bill);

    /**
     * 批量删除入账列表
     * 
     * @param ids 需要删除的入账列表主键集合
     * @return 结果
     */
    public int deleteBillByIds(Long[] ids);

    /**
     * 删除入账列表信息
     * 
     * @param id 入账列表主键
     * @return 结果
     */
    public int deleteBillById(Long id);

    /**
     * 手动生成账单（当前月之后的月份）
     * 
     * @param elderlyId 老人ID
     * @param billMonth 账单月份(格式：YYYY-MM)
     * @return 结果
     */
    public int generateBillManually(Long elderlyId, String billMonth);

    /**
     * 自动生成下月账单（已入住老人）
     * 
     * @return 生成的账单数量
     */
    public int generateBillsAuto();

    /**
     * 生成首期缴费账单（合同签约时调用）
     * 
     * @param elderlyId 老人ID
     * @return 结果
     */
    public int generateFirstBill(Long elderlyId);

    /**
     * 标记欠费账单
     * 
     * @return 标记的账单数量
     */
    public int markOverdueBills();

    /**
     * 获取已入住老人数量（用于账单生成测试）
     * 
     * @return 已入住老人数量
     */
    public int getElderlyCountForBillGeneration();

    /**
     * 获取指定月份已存在的账单数量
     * 
     * @param billMonth 账单月份
     * @return 已存在的账单数量
     */
    public int getExistingBillCount(String billMonth);
}
